.. _Руководство по использованию образа ServiceGate:

######################################################################
Руководство по использованию образов Tautoki ServiceGate
######################################################################

.. _kvm_install:

************************************************
Запуск виртуальной машины в KVM
************************************************

======================================================================
Загрузка образа виртуальной машины в KVM
======================================================================

Образ предоставляется в формате дискового образа QCOW2. Для того, чтобы запустить виртуальную машину в виртуальной среде libvirt в операционной системе Linux  необходимо выполнить действия, описанные ниже.

1. Устанавливаем гипервизор на основе Linux KVM и libvirt (qemu + libvirt)

    .. note::
     | Руководства по установке можно найти на сайте разработчика версии ОС Linux на хосте Например:
     | https://ubuntu.com/server/docs/virtualization-libvirt
     | https://wiki.astralinux.ru/pages/viewpage.action?pageId=3277425

2. Перемещаем поставляемый образ QCOW2 по пути `/var/lib/libvirt/images/`

3. Устанавливаем  владельцем файла образа, служебного пользователя, управляющего виртуальными машинами, например:

 ::

  chown libvirt-qemu:libvirt-qemu /var/lib/libvirt/images/tautoki.qcow2

..

4. Создаем виртуальную машину на основе образа:

 ::

    virt-install \
    --virt-type=kvm \
    --name tautoki \
    --ram 8192 \
    --vcpus=2 \
    --os-variant=rhel7.0 \
    --hvm \
    --network=bridge=br0,model=virtio \
    --graphics vnc,listen=0.0.0.0 \
    --noautoconsole \
    --disk path=/var/lib/libvirt/images/tautoki.qcow2,bus=virtio \
    --boot hd

..

    .. note:: После создания образа, виртуальная машина запускается автоматически

5. Запускаем виртуальную машину

 ::

   virsh start tautoki

..

    .. note::
        | При необходимости можно настроить автозапуск виртуальной машины:
        | `virsh autostart tautoki`

6. Проверяем состояния ВМ.

    .. note:: Дальнейшая настройка осуществляется при помощи VNC.

Для подключения к ВМ по протоколу VNC необходимо выяснить порт, который можно узнать одной из команд:

 ::

    virsh vncdisplay tautoki
    virsh dumpxml tautoki | grep vnc

..

.. note:: Первая команда вернет число. Это число нужно сложить с 5900, в результате получится номер порта машины хоста, к которому необходимо подключиться утилитой VNC.



======================================================================
Базовая настройка рабочего места/виртуальной машины
======================================================================


------------------------------------------------------------------------
Базовая настройка виртуальной машины
------------------------------------------------------------------------

Если внутри виртуальной машины уже настроен ip адрес и он известен, то этот шаг можно пропустить.

| В целях настройки виртуальной машины можно использовать систему удаленного доступа VNC.
| Для этого на рабочем месте должен быть установлен клиент VNC, например, TigerVNC.

Параметры входа в систему виртуальной машины:

 ::

    Логин: sgate
    Пароль: sgate

..

Для операций требующих повышенных привилегий можно использовать sudo.

| Если в сети отсутствует DHCP сервер, то необходимо задать статический ip адрес.
| Пример команды установки временного ip адреса:

 ::

    ip address add <ip>/<mask> dev <ifname>

..

Где,
* ip - предварительно выделенный ip адрес внутри сети компании;
* mask - маска сети;
* ifname - имя интерфейса виртуальной машины, который связан с физической сетью хоста (имя интерфейса зависит от платформы, которую предоставил гипервизор).


------------------------------------------------------------------------
Настройка рабочего места
------------------------------------------------------------------------

На рабочем месте, с которого будет выполняться вход в систему Tautoki, необходимо:

1. Установить сертификат в доверенные корневые центры сертификации.
2. Обеспечить корректный поиск ip адреса виртуальной машины по DNS имени.


************************************************
Загрузка образа виртуальной машины в VirtualBox
************************************************

Образ предоставляется в Открытом формате виртуализации (OVF). Для того, чтобы запустить виртуальную машину в виртуальной среде VirtualBox в операционной системе Windows с русской 
локализацией необходимо выполнить действия, описанные ниже.

1. Открыть интерфейс менеджера VirtualBox: Пуск → Oracle VM VirtualBox (:numref:`22Pic1`).

.. _22Pic1:          
.. figure:: Img/VM.png
       :scale: 80 %
       :align: center

       *Открытие интерфейса Oracle VM VirtualBox*


2. В интерфейсе выбрать вкладку "Инструменты" и пиктограмму "Импортировать" (:numref:`22Pic2`).

.. _22Pic2:          
.. figure:: Img/VM1.png
       :scale: 80 %
       :align: center

       *Пиктограмма "Импортировать"*

3. В открывшимся интерфейсе Импорта конфигураций выбрать файл sgate.ovf из каталога с образом виртуальной машины в открытом формате виртуализации (:numref:`22Pic3`) 
   и нажать на кнопку "Далее".

.. _22Pic3:          
.. figure:: Img/VM2.png
       :scale: 80 %
       :align: center

       *Выбор файла sgate.ovf*

4. При необходимости исправить параметры импорта, например, имя виртуальной машины (поле "Имя") и место хранения виртуальной машины (поле "Папка машины"), 
   далее нажать на кнопку "Импорт" (:numref:`22Pic4`).

.. _22Pic4:          
.. figure:: Img/VM3.png
       :scale: 80 %
       :align: center

       *Импорт образа виртуальной машины*

5. Выбрав загруженную виртуальную машину, нажать на кнопку "Запустить" (:numref:`22Pic5`). Виртуальная машина запущена.

.. _22Pic5:          
.. figure:: Img/VM4.png
       :scale: 80 %
       :align: center

       *Кнопка "Запустить"*